3D Graphics Programming with QuickDraw 3D 1.5.4

Draw Region Descriptor

The TQ3XDrawRegionDescriptor data structure describes the raster into which a renderer draws. This data structure contains dimensions, pixel size, and format information.

You can get a pointer to the TQ3XDrawRegionDescriptor data structure by calling Q3XDrawRegion_Start (link) or Q3XDrawRegion_StartAccessToImageBuffer (link) .



 
typedef struct TQ3XDrawRegionDescriptor {

    unsigned long               width;

    unsigned long               height;

    unsigned long               rowBytes;

    unsigned long               pixelSize;

    TQ3XDevicePixelType         pixelType;

    TQ3XColorDescriptor         colorDescriptor;

    TQ3Endian                   bitOrder;

    TQ3Endian                   byteOrder;

    TQ3Bitmap                   *clipMask;

} TQ3XDrawRegionDescriptor;

width , height: Width and height, in pixels, of the area rendered into.
rowBytes: The raster may be embedded in a larger area of memory, so its scan lines may not be contiguous in memory. This field gives the number of bytes to the next row (scan line).
pixelSize: The number of bytes in each pixel.
pixelType: The formatting type of the pixel; see "Device Pixel Types" .
colorDescriptor: Currently not used.
bitOrder , byteOrder: Endianess; may be kQ3EndianBig or kQ3EndianLittle .
clipMask: The clip mask for the region; may be NULL .

Device Pixel Types

Color Descriptor

Clipping Information